Inside Macintosh: QuickDraw GX Printing /

Chapter 3 - Page Formatting and Dialog Box Customization / Page Formatting and Dialog Box Customization Reference

Functions / Creating and Manipulating Format Objects

GXCloneFormat

You can use the GXCloneFormat function to increment the owner count of a format object by 1.

gxFormat GXCloneFormat (gxFormat aFormat);

aFormat

A reference to the format object you wish to clone.

function result

A reference to a format object.

DESCRIPTION

When a user wants to share a format with another page in the same document, you use the GXCloneFormat function to increment the owner count of a format object by 1, which prevents it from being deleted if it is disposed of when the other page no longer needs the format.

You can use the GXCountFormatOwners function to obtain the current owner count of a format object.

RESULT CODES

gxSegmentLoadFailedErr

A required code segment could not be found, or there was not enough memory to load it.

SEE ALSO

Listing 3-10 on page 3-46 shows how to use the GXCloneFormat function to increment the owner count of a format object by 1.

The GXNewFormat function, which creates a new format object with an owner count of 1, is described on page 3-104.

The GXDisposeFormat function for decrementing the owner count of a format object by 1 is described on page 3-104.

The GXCountFormatOwners function for obtaining the current owner count of a format object is described on page 3-107.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help